DCC 3DS2.0 API一覧 | マルペイDocs

多通貨クレジットカード決済（DCC） 3DS2.0 API一覧

HTTP仕様（.idPass）

HTTP仕様（.json）

Request header		Content-Type: application/x-www-form-urlencoded;charset=windows-31j
Method		POST
Response header		Content-Type: text/plain;charset=windows-31j
Status Code		200：常に200を返却

Request header		Content-Type: application/json;charset=UTF-8
Method		POST
Response header		Content-Type: application/json;charset=UTF-8
Status Code		200：正常時 400：入力パラメータエラー、加盟店設定エラー 500：システムエラー 502：決済エラー　　　　　　　 ※以下のエラーコードはhttp200で返却される可能性がございます。　・E90010001 　・E92000001 　・E92000002 　・E91099996 　・E91099997

EntryTranDcc 取引登録

これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。

リクエスト

ShopID	shopID	必須半角英数13桁ショップID
ShopPass	shopPass	必須半角英数64桁ショップパスワード
OrderID	orderID	必須半角英数記号27桁オーダーID
ItemCode	itemCode	半角数字7桁商品コードデフォルトは「0000990」になります。
DccCurrency	dccCurrency	必須半角英字3桁支払通貨コード設定できるコードについてはこちら
Ftn	ftn	半角数字12桁 FX追跡番号最大12桁の数字を設定します。省略時は、最新の為替レートが要求されます。
Amount	amount	必須半角数字7桁利用金額利用金額(日本円)を設定します。
Tax	tax	半角数字7桁税送料税送料(日本円)を指定した場合は、利用金額+税送料を支払通貨で換算した値が支払金額となります。
TdFlag	tdFlag	3DS利用フラグ 2：行う（3DS2.0を利用）
TdTenantName	tdTenantName	半角英数記号25桁 3DS表示店舗名表示店舗名をEUC-JPでBASE64エンコーディングした値を設定 25Byte以内である必要があります。英数半角に設定することを推奨します。事前にテスト環境で検証してください。デフォルトは「未指定」になります。
Tds2Type	tds2Type	3DS2.0未対応時取り扱い仕向先カード会社が3DS2.0に未対応な場合の後続処理設定 1：3DS1.0での認証を実施（デフォルト） 2：エラーとして処理終了 3：通常オーソリを実施 3DS1.0認証サポート終了のため、1以外を指定してください。 1を指定した場合、E21040002（3DS1.0閉塞後利用エラー）を返却します。

URL

/payment/EntryTranDcc.json

リクエストパラメータ

{
  "shopID": "tshop11223344",
  "shopPass": "PASSWORD",
  "orderID": "ORDER0000001",
  "dccCurrency": "USD",
  "amount": "1000"
}

URL

/payment/EntryTranDcc.idPass

リクエストパラメータ

ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&DccCurrency=USD&Amount=1000

レスポンス

正常

OrderID	orderID	半角英数記号27桁オーダーID
AccessID	accessID	半角英数32桁固定取引ID
AccessPass	accessPass	半角英数32桁固定取引パスワード
DccCurrency	dccCurrency	半角英字3桁支払通貨コード
DccAmount	dccAmount	半角数字記号12桁支払通貨決済額支払通貨換算後の金額を返却します。 (整数部10桁、小数部2桁)
DccRate	dccRate	半角数字記号11桁為替レート支払通貨換算に適用した為替レートを返却します。(整数部6桁、小数部5桁)
Ftn	ftn	半角数字12桁 FX追跡番号(FTN) 入力パラメータの値を返却します。省略した場合は、支払通貨換算に適用した為替レートに紐付くFTNを返却します。

異常

ErrCode		errCode		半角英数3桁固定エラーコード
ErrInfo		errInfo		半角英数9桁固定エラー詳細コード

レスポンスパラメータ：正常系

{
  "orderID": "ORDER0000001",
  "accessID": "a6a6b0061347e90cdef806b39bd28705",
  "accessPass": "5e0e54b892e14ed03e8cf807a6053813",
  "dccCurrency": "USD",
  "dccAmount": "1.11",
  "dccRate": "0.01111",
  "ftn": "11111111"
}

レスポンスパラメータ：正常系

OrderID=ORDER0000001&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&DccCurrency=USD&DccAmount=1.11&DccRate=0.01111&Ftn=11111111

レスポンスパラメータ：異常系

[
    {
        "errCode":"E01",
        "errInfo":"E01040001"
    }
]

レスポンスパラメータ：異常系

ErrCode=E01&ErrInfo=E01040001

ExecTranDcc 決済実行

カード会社と通信を行い決済をします。
3DS2.0にカード会社が未対応の場合は、取引登録時に指定されたTds2Typeの値により対応します。
パラメータに設定する「カード会員」情報については、当サービスではなく加盟店様にて管理している会員の情報になります。
カード会員情報はリスクベース認証に利用します。不明な情報については設定不要です。

利用する決済方法を選択し、共通パラメータに加えて、必要なパラメータを設定してください。
他決済方法のパラメータを指定した場合、想定外の決済方法で処理されることがございますのでご注意ください。

トークンを利用して決済する場合

トークン発行後、呼び出してください。
会員ID決済する場合
会員ID/カード登録後、呼び出してください。
カード番号を利用して決済する場合
カード番号の取り扱いが許可された加盟店様のみ利用可能です。トークンとカード番号・有効期限・セキュリティコード・名義人を併せて指定するとトークンが優先されます。

カード番号の取り扱いが許可されていない加盟店様については、パラメータを指定した場合はE61040001エラーが発生します。

リクエスト

ShopID	shopID	必須半角英数13桁ショップID
ShopPass	shopPass	必須半角英数64桁ショップパスワード
AccessID	accessID	必須半角英数32桁固定取引ID 【取引登録】で発行された値を設定します。
AccessPass	accessPass	必須半角英数32桁固定取引パスワード【取引登録】で発行された値を設定します。
OrderID	orderID	必須半角英数記号27桁オーダーID 【取引登録】で指定した値を設定します。
ClientField1	clientField1	全半角100バイト加盟店自由項目1
ClientField2	clientField2	全半角100バイト加盟店自由項目2
ClientField3	clientField3	全半角100バイト加盟店自由項目3
ClientFieldFlag	clientFieldFlag	加盟店自由項目返却フラグ 0：返却しない（デフォルト） 1：返却する

トークンを使用する場合
各パラメータはトークン利用のみ設定してください。

Token		token		必須半角英数64桁トークン

会員IDを使用する場合
下記パラメータは会員ID利用のみ設定してください。

SiteID	siteID	必須半角英数13桁サイトID
SitePass	sitePass	必須半角英数10桁サイトパスワード
MemberID	memberID	必須半角英数記号60桁会員ID
SeqMode	seqMode	カード登録連番モード 0：論理モード（デフォルト） 1：物理モード物理モードの場合、削除カードでの決済が可能です。
CardSeq	cardSeq	必須半角数字4桁カード登録連番
CardPass	cardPass	半角英数20桁カードパスワードカード登録時に設定したパスワードカード登録時にCardPassをセットした会員IDを利用して決済する場合は必須です。
SecurityCode	securityCode	半角数字4桁セキュリティーコードカードに記載されている3桁もしくは4桁の数字

カード番号を使用する場合
下記パラメータはカード番号利用のみ設定してください。

CardNo	cardNo	必須半角数字16桁クレジットカード番号
Expire	expire	必須半角数字4桁固定有効期限クレジットカードの有効期限 YYMM形式
SecurityCode	securityCode	半角数字4桁セキュリティコードカードに記載されている3桁もしくは4桁の数字

CardNo

cardNo

必須半角数字16桁

有効期限

クレジットカードの有効期限
YYMM形式

SecurityCode

securityCode

半角数字4桁

3DS2.0利用パラメータ
下記パラメータは3DS2.0利用時に設定してください。

RetUrl	retUrl	必須半角英数記号256桁加盟店戻りURL 3Dセキュア認証後にお戻しする加盟店様側のURLになります。通常は必ず指定してください。モバイルアプリSDKを利用する場合は設定不要です。 URLに遷移するHTTPメソッド(GET/POST)は、CallbackTypeパラメータで切り替えることができます。
CallbackType	callbackType	コールバック方法加盟店様が指定した戻りURLに当社から戻す方式を指定します。通常は「1」(POST方式)または「3」(GET方式)を設定してください。モバイルアプリSDKを利用する場合は設定不要です。 1：通常（POST方式）（デフォルト） 2：直接受ける 3：通常（GET方式）「1」または「3」の場合、認証後のコールバック一回のみで済みます。(決済フローの「通常コールバック方式」参照) 「2」を指定すると認証初期化後、チャレンジ後の最大二回のコールバックが発生し、加えて以下のAPIを呼び出す必要があります。こちらの方式では加盟店様側で認証結果を取得できるので認証エラーの場合はオーソリを行わないようにする等、決済フローの制御が可能になります。(決済フローの「都度加盟店コールバック方式」参照) 3DS2.0認証実行 3DS2.0認証結果取得
Tds2ChAccChange	tds2ChAccChange	半角数字8桁固定会員最終更新日加盟店サイト上のこの会員の情報が更新された日付を設定します。決済用カード情報の追加や配送先住所の変更がされた日付を想定しています。新規登録された会員の場合は登録日を設定してください。更新された日付が不明な場合は未設定で構いません YYYYMMDD形式です。
Tds2ChAccDate	tds2ChAccDate	半角数字8桁固定会員作成日加盟店サイト上にてこの会員が新規登録された日付を設定します。クレジットカード番号を登録した日ではありません。ゲストとして取引を行う場合は未設定で構いません。 YYYYMMDD形式です。
Tds2ChAccPwChange	tds2ChAccPwChange	半角数字8桁固定会員パスワード変更日加盟店サイト上のこの会員のログインパスワードが変更された日付を設定します。パスワード忘れなどでリセットした場合も含まれます。ゲストとして取引を行っている場合、またはパスワードを変更したことが無い場合は未設定で構いません。 YYYYMMDD形式です。
Tds2NbPurchaseAccount	tds2NbPurchaseAccount	半角数字4桁過去6ヶ月間の購入回数加盟店サイト上にて過去6ヵ月間にこの会員がクレジットカード決済で決済成功して購入完了に至った回数を設定します。対象期間の開始日について、処理日が8/20であれば3/1以降としても良いですし、処理日時点の180日前以降としても問題ありません。
Tds2PaymentAccAge	tds2PaymentAccAge	半角数字8桁固定カード登録日加盟店サイト上のこの会員が今回の決済で利用するカード情報を登録した日付を設定します。都度カード番号を入力する場合は未設定で構いません。
Tds2ProvisionAttemptsDay	tds2ProvisionAttemptsDay	半角数字3桁過去24時間のカード追加試行回数加盟店サイト上のこの会員が、過去24時間以内にカード情報を登録した試行回数を設定します。複数種類のカードで試して失敗した回数も含めていただきます。しかし成功した回数しか分からない場合は成功回数だけで構いません。
Tds2ShipAddressUsage	tds2ShipAddressUsage	半角数字8桁固定配送先住所の初回使用日この取引での指定された配送先住所が、初めて利用された日付を設定します。過去の実績はクレジットカード決済で行われたかは問いません。加盟店サイトにて記録されている最も古い取引時の日付で構いません。会員登録なしでの取引、配送が発生しない場合は未設定で構いません。 YYYYMMDD形式です。
Tds2ShipNameInd	tds2ShipNameInd	カード会員名と配送先名の一致/不一致この取引でのクレジットカード番号の会員名と配送先情報の宛名が一致しているかを指定します。 01：カード会員名と配送先名が一致 02：カード会員名と配送先名が不一致配送が発生しない場合や配送先の宛名が不明の場合は未設定で構いません。
Tds2SuspiciousAccActivity	tds2SuspiciousAccActivity	不審行為情報今回の取引に限らずこの会員が加盟店サイト上にて不審な行動をしているかどうかを指定します。 01：不審な行動は見られなかった 02：不審な行動が見られた不明、または判断が困難な場合は未設定で構いません。過去に不正利用をしている、一般的には発生しない操作が記録されているなどの場合に設定してください。
Tds2TxnActivityDay	tds2TxnActivityDay	半角数字3桁過去24時間のカード会員の取引回数加盟店サイト上のこの会員が、過去24時間以内に取引を行った回数を設定します。クレジットカード決済で行われたか、決済に成功したかは問いません。回数が分からない場合は未設定で構いません。しかし、記録されている限りの回数を設定するようお願いします。
Tds2TxnActivityYear	tds2TxnActivityYear	半角数字3桁過去1年の取引回数加盟店サイト上のこの会員が、過去1年以内に取引を行った回数を設定します。クレジットカード決済で行われたか、決済に成功したかは問いません。対象とする期間は厳密に過去1年とする必要はありません。処理日が2022年10月10日の場合、2021年9月～2022年9月や2021年10月10日～2022年10月9日、または直近365日としても問題ありません。また1年分の履歴を保持していない場合、可能な範囲での算出で構いません。回数が分からない場合は未設定で構いません。しかし、記録されている限りの回数を設定するようお願いします。
Tds2ThreeDSReqAuthTimestamp	tds2ThreeDSReqAuthTimestamp	半角数字12桁固定ログイン日時この会員が加盟店サイトにログインした日時を設定します。ゲストとしてログインしている場合は未設定で構いません。 YYYYMMDDHHMM形式です。
Tds2ThreeDSReqAuthMethod	tds2ThreeDSReqAuthMethod	ログイン方法この会員が加盟店サイトへのログイン時に認証した方法を指定します。 01：認証なし、ゲストログイン 02：加盟店サイト自身の認証情報 03：フェデレーションIDを利用した認証 04：イシュアの認証情報　　カード会社が提供しているポイントサイトなどのログイン認証などで認証済みとしている場合 05：サードパーティ認証　　Facebook、Googleなど他サービスの認証を利用
Tds2ThreeDSReqAuthData	tds2ThreeDSReqAuthData	全半角2048桁ログイン証跡データ「ログイン方法(Tds2ThreeDSReqAuthMethod)」に、"03" を指定した場合にフェデレーションIDのプロバイダーに関する情報と関連情報を設定します。それ以外を指定している場合は未設定で構いません。
Tds2AddrMatch	tds2AddrMatch	請求先住所と配送先住所の一致/不一致この取引での請求先住所と配送先情報が一致しているかを指定します。 Y：一致 N：不一致配送が発生しない場合や判断ができない場合は未設定で構いません。コンビニ受け取りのような場合は不一致としてください。
Tds2BillAddrCity	tds2BillAddrCity	全半角50桁請求先住所の市区町村この取引での請求先住所の「市区町村」を設定します。例として「渋谷区」「横浜市」となります。日本語漢字でなくても構いません。請求先住所情報を保持していない場合は未設定で構いません。
Tds2BillAddrCountry	tds2BillAddrCountry	半角数字3桁固定請求先住所の国番号この取引での請求先住所の「国番号」を設定します。設定する番号はISO3166-1の数字3桁となります。 ITU-E.164ではないのでご注意ください。例として日本の場合は「392」です。請求先住所情報を保持していない場合は未設定で構いません。
Tds2BillAddrLine1	tds2BillAddrLine1	全半角50桁請求先住所の町域・丁目番地この取引での請求先住所の「町域・丁目番地」を設定します。請求先住所情報を保持していない場合や詳細住所が不明の場合は未設定で構いません。保持している住所を町名と建物名に分割するのが難しい場合は、桁数が収まるようにTds2BillAddrLine1～Tds2BillAddrLine3に住所を設定してください。Tds2BillAddrLine1にすべて収まる場合は、Tds2BillAddrLine2とTds2BillAddrLine3は未設定で構いません。また、都道府県や市区が含まれていても構いません。
Tds2BillAddrLine2	tds2BillAddrLine2	全半角50桁請求先住所の建物・号室この取引での請求先住所の「建物・号室」を設定します。請求先住所情報を保持していない場合や詳細住所が不明の場合は未設定で構いません。
Tds2BillAddrLine3	tds2BillAddrLine3	全半角50桁請求先住所情報の予備項目請求先住所情報に関する予備項目です。設定は不要です。
Tds2BillAddrPostCode	tds2BillAddrPostCode	半角英数16桁請求先住所の郵便番号この取引での請求先住所の「郵便番号」を設定します。ハイフンは含めても、含まなくてもどちらでも構いません。請求先住所情報を保持していない場合は未設定で構いません。
Tds2BillAddrState	tds2BillAddrState	半角英数3桁請求先住所の都道府県番号この取引での請求先住所の「都道府県番号」を設定します。こちらの都道府県コード表を参照してください。 https://www.meti.go.jp/policy/chemical_management/kasinhou/files/ippantou/table_prefecturecode.pdf 「01」～「47」からなる先頭ゼロ埋めの2桁の形式です。請求先住所情報を保持していない場合は未設定で構いません。
Tds2Email	tds2Email	半角英数記号254桁メールアドレスこの会員の電子メールアドレスを設定します。「RFC 5322」の仕様に沿った形式のみ許可されます。 2連続ドットなどのRFC違反の形式となっているメールアドレスの場合はエラーとなるため設定しないでください。メールアドレスを保持していない場合は未設定で構いません。
Tds2HomePhoneCC	tds2HomePhoneCC	半角数字3桁固定自宅電話の国コードこの会員の自宅電話の「国コード」を設定します。設定する国コードはITU-E.164の1～3桁の数字となります。 ISO3166-1ではないのでご注意ください。例として日本の場合は「81」です。プラス記号(+)はつけないでください。
Tds2HomePhoneSubscriber	tds2HomePhoneSubscriber	半角数字15桁この会員の自宅電話番号を設定します。先頭一桁目のゼロは不要です。例として東京都の場合は「3-1234-5678」です。ハイフンは含めても、含まなくてもどちらでも構いません。自宅電話として携帯電話が登録されている場合は携帯電話番号を設定してください。
Tds2MobilePhoneCC	tds2MobilePhoneCC	半角数字3桁固定携帯電話の国コードこの会員の携帯電話の「国コード」を設定します。設定する国コードはITU-E.164の1～3桁の数字となります。 ISO3166-1ではないのでご注意ください。例として日本の場合は「81」です。プラス記号(+)はつけないでください。
Tds2MobilePhoneSubscriber	tds2MobilePhoneSubscriber	半角数字15桁携帯電話番号この会員の携帯電話番号を設定します。先頭一桁目のゼロは不要です。例として「90-1234-5678」です。ハイフンは含めても、含まなくてもどちらでも構いません。
Tds2WorkPhoneCC	tds2WorkPhoneCC	半角数字3桁固定職場電話の国コードこの会員の職場電話の「国コード」を設定します。設定する国コードはITU-E.164の1～3桁の数字となります。 ISO3166-1ではないのでご注意ください。例として日本の場合は「81」です。プラス記号(+)はつけないでください。職場電話情報が無い場合は未設定で構いません。
Tds2WorkPhoneSubscriber	tds2WorkPhoneSubscriber	半角数字15桁職場電話番号この会員の自宅電話番号を設定します。先頭一桁目のゼロは不要です。例として東京都の場合は「3-1234-5678」です。ハイフンは含めても、含まなくてもどちらでも構いません。職場電話情報が無い場合は未設定で構いません。
Tds2ShipAddrCity	tds2ShipAddrCity	全半角50桁配送先住所の市区町村この取引での配送先住所の「市区町村」を設定します。例として「渋谷区」「横浜市」となります。日本語漢字でなくても構いません。配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。
Tds2ShipAddrCountry	tds2ShipAddrCountry	半角数字3桁固定配送先住所の国番号この取引での配送先住所の「国番号」を設定します。設定する番号はISO3166-1の数字3桁となります。 ITU-E.164ではないのでご注意ください。例として日本の場合は「392」です。配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。
Tds2ShipAddrLine1	tds2ShipAddrLine1	全半角50桁配送先住所の町域・丁目番地この取引での配送先住所の「町域・丁目番地」を設定します。配送が発生しない場合や配送先住所情報を保持していない場合、詳細住所が不明の場合は未設定で構いません。保持している住所を町名と建物名に分割するのが難しい場合は、桁数が収まるようにTds2ShipAddrLine1～Tds2ShipAddrLine3に住所を設定してください。Tds2ShipAddrLine1にすべて収まる場合は、Tds2ShipAddrLine2とTds2ShipAddrLine3は未設定で構いません。また、都道府県や市区が含まれていても構いません。
Tds2ShipAddrLine2	tds2ShipAddrLine2	全半角50桁配送先住所の建物・号室この取引での配送先住所の「建物・号室」を設定します。配送が発生しない場合や配送先住所情報を保持していない場合、詳細住所が不明の場合は未設定で構いません。
Tds2ShipAddrLine3	tds2ShipAddrLine3	全半角50桁配送先住所情報の予備項目配送先住所情報に関する予備項目です。設定は不要です。
Tds2ShipAddrPostCode	tds2ShipAddrPostCode	半角英数16桁配送先住所の郵便番号この取引での配送先住所の「郵便番号」を設定します。ハイフンは含めても、含まなくてもどちらでも構いません。配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。
Tds2ShipAddrState	tds2ShipAddrState	半角英数3桁配送先住所の都道府県この取引での配送先住所の「都道府県番号」を設定します。こちらの都道府県コード表を参照してください。 https://www.meti.go.jp/policy/chemical_management/kasinhou/files/ippantou/table_prefecturecode.pdf 「01」～「47」からなる先頭ゼロ埋めの2桁の形式です。配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。
Tds2DeliveryEmailAddress	tds2DeliveryEmailAddress	半角英数記号254桁電子配送時の配送先メールアドレスこの取引内容がWebチケットなどの電子デリバリーの場合に、配信先の電子メールアドレスを設定します。「RFC 5322」の仕様に沿った形式のみ許可されます。 2連続ドットなどのRFC違反の形式となっているメールアドレスの場合はエラーとなるため設定しないでください。電子デリバリーではない場合は未設定で構いません。
Tds2DeliveryTimeframe	tds2DeliveryTimeframe	商品出荷の時間枠商品納品時間枠を指定します。 01：電子デリバリー、商品の出荷が発生しない 02：当日出荷 03：翌日出荷 04：2日目以降の出荷
Tds2GiftCardAmount	tds2GiftCardAmount	半角数字15桁プリペイドカード/ギフトカード購入の総金額この取引がプリペイドカードまたはギフトカード購入の場合、購入した総金額を設定します。
Tds2GiftCardCount	tds2GiftCardCount	半角数字2桁プリペイドカード/ギフトカード購入の総件数この取引がプリペイドカードまたはギフトカード購入の場合、購入した総枚数を設定します。
Tds2GiftCardCurr	tds2GiftCardCurr	半角数字3桁固定プリペイドカード/ギフトカード購入の通貨コードこの取引がプリペイドカードまたはギフトカード購入の場合、購入の通貨コードを設定します。設定する番号はISO 4217の数字3桁となります。 ITU-E.164ではないのでご注意ください。例として日本円の場合は「392」です。
Tds2PreOrderDate	tds2PreOrderDate	半角数字8桁固定予約販売の発売予定日この取引が先行予約販売による決済の場合に、商品の発売予定日を設定します。 YYYYMMDD 形式です。発売予定日が不明の場合は未設定で構いません。
Tds2PreOrderPurchaseInd	tds2PreOrderPurchaseInd	予約販売の商品有無この取引が先行予約販売による決済の場合に、商品が現時点で存在するかどうかを指定します。 01：商品がある 02：予約の商品、まだ存在しない
Tds2ReorderItemsInd	tds2ReorderItemsInd	再購入情報この会員が取引対象の商品の以前も購入したことがあるかを指定します。 01：新規購入 02：再購入判別が困難な場合は未設定で構いません。新規と再購入が混在している場合は、新規購入として設定してください。
Tds2ShipInd	tds2ShipInd	商品配送方法この取引での商品の配送方法を設定します。 01：カード会員の請求先住所に配送する 02：加盟店様が保持している別の確認済み住所に配送する 03：カード会員の請求先住所と異なる住所に配送する 04：店舗へ配送/近所の店舗での受け取りであり店舗の住所は配送先住所で指定する 05：デジタル商品、オンラインサービス、電子ギフトカードおよび償還コードを含む 06：配送なし、旅行およびイベントのチケットなど 07：その他、ゲーム、配送されないデジタルサービス、電子メディアの購読料など

URL

/payment/ExecTranDcc.json

リクエストパラメータ：トークン利用

{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "orderID":"TEST-20190628-133057",
    "clientField1":"項目１",
    "clientField2":"項目２",
    "clientField3":"項目３",
    "clientFieldFlag":"1",
    "token":"Lg9sRgo5nx6yfefJ51z8bj/1VdNFAaCZYWZ+qLKJyqWwBS7yYvxSiC0zeMVH+O4F"
}

リクエストパラメータ：会員ID利用

{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "orderID":"TEST-20190628-133057",
    "siteID":"tsite99887814",
    "sitePass":"aqcg741pcw",
    "memberID":"Member00",
    "seqMode":"0",
    "cardSeq":"0001",
    "cardPass":"PassWord",
    "clientField1":"項目１",
    "clientField2":"項目２",
    "clientField3":"項目３",
    "clientFieldFlag":"1"
}

リクエストパラメータ：カード番号利用

{
    "shopID":"tshop11223344",
    "shopPass":"PASSWORD",
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
    "orderID":"TEST-20190628-133057",
    "clientField1":"項目１",
    "clientField2":"項目２",
    "clientField3":"項目３",
    "clientFieldFlag":"1",
    "cardNo":"4111111111111111",
    "expire":"2512"
}

URL

/payment/ExecTranDcc.idPass

リクエストパラメータ：トークン利用

ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&OrderID=TEST-20190628-133057&ClientField1=項目１&ClientField2=項目2&ClientField3=項目３&ClientFieldFlag=1&Token=Lg9sRgo5nx6yfefJ51z8bj/1VdNFAaCZYWZ+qLKJyqWwBS7yYvxSiC0zeMVH+O4F

リクエストパラメータ：会員ID利用

ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&OrderID=TEST-20190628-133057&SiteID=tsite99887814&SitePass=aqcg741pcw&MemberID=Member00&SeqMode=0&CardSeq=0001&CardPass=PassWord&ClientField1=項目１&ClientField2=項目２&ClientField3=項目３&ClientFieldFlag=1

リクエストパラメータ：カード番号利用

ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&OrderID=TEST-20190628-133057&ClientField1=項目１&ClientField2=項目２&ClientField3=項目３&ClientFieldFlag=1&CardNo=4111111111111111&Expire=2512

レスポンス

正常

ACS	acs	ACS呼出判定 2：ACS呼出要(3DS2.0)
RedirectUrl	redirectUrl	3DSサーバーへのリダイレクトURL 3DS2.0認証初期化へのURL(※１) リダイレクト先ドメインテスト環境：pt01.mul-pay.jp 本番環境：manage.tds2gw.gmopg.jp
※１：値に"&"や"="が含まれます。idPass版をご利用の場合は文字列のパースにご注意ください。

ACS

acs

3DSサーバーへのリダイレクトURL

3DS2.0認証初期化へのURL(※１)

リダイレクト先ドメイン
テスト環境：pt01.mul-pay.jp
本番環境：manage.tds2gw.gmopg.jp

※１：値に"&"や"="が含まれます。idPass版をご利用の場合は文字列のパースにご注意ください。

異常

ErrCode		errCode		半角英数3桁固定エラーコード
ErrorInfo		errorInfo		半角英数9桁固定エラー詳細コード

レスポンスパラメータ：正常系

{
    "acs":"2",
    "redirectUrl":"https://manage.tds2gw.gmopg.jp/api/v2/brw/callback?transId=6e48e31f-2940-48e1-a702-ebba2f3373ee&t=dccc8a7ed85372c9accff576bff59b3a"
}

レスポンスパラメータ：異常系

[
    {
        "errCode":"M01",
        "errInfo":"M01470008"
    }
]

レスポンスパラメータ：正常系

ACS=2&RedirectUrl=https://manage.tds2gw.gmopg.jp/api/v2/brw/callback?transId=6e48e31f-2940-48e1-a702-ebba2f3373ee&t=dccc8a7ed85372c9accff576bff59b3a

レスポンスパラメータ：異常系

ErrCode=M01&ErrInfo=M01470008

カード会社の3DS2.0画面を呼び出す

この部分は当サービスではなく、お客様と3DSサービスのやりとりとなりますので、加盟店様は当サービスより返却したRedirectUrlにお客様を誘導します。
RedirectUrlはHTTPメソッド GETで遷移しますので、以下のリダイレクトHTTPヘッダ、またはリダイレクトページのサンプルを参考に呼び出してください。
3DS2.0ではカード会社側の判定によりパスワード入力画面が不要となる場合がございます。

リクエスト

RedirectUrl	必須 3DS2.0開始 URL 【決済実行】で発行された値

RedirectUrl

必須

3DS2.0開始 URL

【決済実行】で発行された値

リダイレクトHTTPヘッダサンプル

HTTP/1.1 302 Found
Location: {RedirectUrl}

リダイレクトページサンプル

<html>
 <head>
  <meta http-equiv="refresh" content="0; URL={RedirectUrl}" />
 </head>
</html>

レスポンス（当サービス⇒加盟店様）

【決済実行】で設定されたRetUrlに、本サービスより以下パラメータを送信します。

正常

AccessID	半角英数32桁固定取引ID 【取引登録】で発行された値

AccessID

半角英数32桁固定

取引ID

【取引登録】で発行された値

3DS2.0サーバーからのコールバック

【決済実行】で設定されたRetUrlで3DSサーバーからのコールバックを受けることができます。

コールバックは下記のタイミングで行われます。

加盟店様が3DS2.0開始URL（RedirectUrl）に誘導し（リダイレクトするように仕向け）、3DSサーバーの3DS2.0認証初期化が完了した後
加盟店様が3DS2.0認証チャレンジURL（ChallengeUrl）に誘導し（リダイレクトするように仕向け）、カード所有者による本人認証が完了した後

3DSサーバーからのコールバックを直接受けるには、【決済実行】のコールバック方法に「2：直接受ける」を設定する必要があります。
コールバックのHTTP Method はPOSTです。

コールバックパラメータ（3DS⇒加盟店様）

正常

MD		半角英数32桁固定取引ID 【取引登録】で発行された値この値はURLクエリパラメータに設定されます。
RequestorTransId		リクエスター取引ID （この値は使いません）
Event		イベント 3DSMethodFinished：3DS2.0初期化処理が完了しました。3DS2.0認証処理を実行してください。 3DSMethodSkipped：3DS2.0初期化処理をスキップした。3DS2.0認証処理を実行してください。 AuthResultReady：3DS2.0認証結果取得の準備が完了しました。
Param		半角英数2000桁 3DS2.0認証パラメータ 3DSサーバーが設定するPOSTパラメータこの値は3DS2.0認証実行で必要になります。

Tds2AuthDcc 3DS2.0認証実行

3DS2.0認証を実行します。
3DS2.0認証初期化URL（RedirectUrl）のコールバックを受けたタイミングで本処理を実行してください。

リクエスト

AccessID	accessID	必須半角英数32桁固定取引ID
AccessPass	accessPass	必須半角英数32桁固定取引パスワード
Tds2Param	tds2Param	必須半角英数記号2000桁 3DS2.0認証パラメータ加盟店様が取引を識別するための値

AccessID

accessID

必須半角英数32桁固定

取引ID

AccessPass

accessPass

必須半角英数32桁固定

取引パスワード

Tds2Param

tds2Param

必須半角英数記号2000桁

3DS2.0認証パラメータ

加盟店様が取引を識別するための値

URL

/payment/Tds2AuthDcc.json

リクエストパラメータ

{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de",
"tds2Param":"eyJicm93c2VyQWNjZXB0SGVhZGVyIjoidGV4dC9odG1sLGFwcGxpY2F0aW9uL3hodG1sK3htbCxhcHBsaWNhdGlvbi94bWw7cT0wLjksKi8qO3E9MC44IiwiYnJvd3NlcklQIjoiMTkyLjE2OC4xLjExIiwiYnJvd3NlckphdmFFbmFibGVkIjpmYWxzZSwiYnJvd3Nlckxhbmd1YWdlIjoiZW4iLCJicm93c2VyQ29sb3JEZXB0aCI6IjQ4IiwiYnJvd3NlclNjcmVlbkhlaWdodCI6IjQwMCIsImJyb3dzZXJTY3JlZW5XaWR0aCI6IjYwMCIsImJyb3dzZXJUWiI6IjAiLCJicm93c2VyVXNlckFnZW50IjoiTW96aWxsYS81LjAgKFdpbmRvd3MgTlQgNi4xOyBXaW42NDsgeDY0OyBydjo0Ny4wKSBHZWNrby8yMDEwMDEwMSBGaXJlZm94LzQ3LjAifQ"
}

URL

/payment/Tds2AuthDcc.idPass

リクエストパラメータ

AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de&Tds2Param=eyJicm93c2VyQWNjZXB0SGVhZGVyIjoidGV4dC9odG1sLGFwcGxpY2F0aW9uL3hodG1sK3htbCxhcHBsaWNhdGlvbi94bWw7cT0wLjksKi8qO3E9MC44IiwiYnJvd3NlcklQIjoiMTkyLjE2OC4xLjExIiwiYnJvd3NlckphdmFFbmFibGVkIjpmYWxzZSwiYnJvd3Nlckxhbmd1YWdlIjoiZW4iLCJicm93c2VyQ29sb3JEZXB0aCI6IjQ4IiwiYnJvd3NlclNjcmVlbkhlaWdodCI6IjQwMCIsImJyb3dzZXJTY3JlZW5XaWR0aCI6IjYwMCIsImJyb3dzZXJUWiI6IjAiLCJicm93c2VyVXNlckFnZW50IjoiTW96aWxsYS81LjAgKFdpbmRvd3MgTlQgNi4xOyBXaW42NDsgeDY0OyBydjo0Ny4wKSBHZWNrby8yMDEwMDEwMSBGaXJlZm94LzQ3LjAifQ

レスポンス

【決済実行】で設定されたRetUrlに、当サービスより以下パラメータを送信します。
認証結果に応じて認証フローを制御する必要があります。
・「Y：認証／口座確認に成功」または「A：処理の試行が実施された」の場合、当サービスの【3DS2.0認証後決済実行】を行ってください。
・「C：認証チャレンジが必要」の場合、3DS2.0認証チャレンジURLにリダイレクトしてください。リダイレクトは3DS2.0開始URL（RedirectUrl）のリダイレクトサンプルを参照ください。
・「N：未認証／口座未確認。取引拒否」または「U：認証／口座確認を実行できなかった」、「R：認証 / 口座確認が拒否された」の場合、取引を中断してください。

正常

Tds2TransResult	tds2TransResult	半角英数1桁固定認証結果 Y：認証／口座確認に成功 A：処理の試行が実施された C：認証チャレンジが必要 N：未認証／口座未確認。取引拒否 U：認証／口座確認を実行できなかった R：認証／口座確認が拒否された
Tds2TransResultReason	tds2TransResultReason	半角英数2桁固定認証結果理由 01：カード認証に失敗した 02：不明なデバイス 03：サポートされていないデバイス 04：認証頻度の上限を超えた 05：有効期限切れのカード 06：無効なカード番号 07：無効な取引 08：カードのレコードが存在しない 09：セキュリティ障害 10：盗難カード 11：不正の疑い 12：カード会員に取引が許可されていない 13：カード会員がサービスに登録されていない 14：取引がACSでタイムアウトした 15：信頼度が低い 16：信頼度が中程度 17：信頼度が高い 18：信頼度が非常に高い 19：ACSの最大チャレンジを超える 20：非決済取引はサポートされていません 21：3RIトランザクションはサポートされていません 22：ACSの技術的な問題 26：認証は試行されましたが、カード会員によって実行されませんでした 80-99：DS（ディレクトリサーバー）の利用枠
ChallengeUrl	challengeUrl	半角英数256桁固定 3DS2.0認証チャレンジURL 認証結果が「C：チャレンジ」の場合に返却します。

Tds2TransResult

tds2TransResult

半角英数1桁固定

認証結果

Y：認証／口座確認に成功
A：処理の試行が実施された
C：認証チャレンジが必要
N：未認証／口座未確認。取引拒否
U：認証／口座確認を実行できなかった
R：認証／口座確認が拒否された

Tds2TransResultReason

tds2TransResultReason

半角英数2桁固定

認証結果理由

01：カード認証に失敗した
02：不明なデバイス
03：サポートされていないデバイス
04：認証頻度の上限を超えた
05：有効期限切れのカード
06：無効なカード番号
07：無効な取引
08：カードのレコードが存在しない
09：セキュリティ障害
10：盗難カード
11：不正の疑い
12：カード会員に取引が許可されていない
13：カード会員がサービスに登録されていない
14：取引がACSでタイムアウトした
15：信頼度が低い
16：信頼度が中程度
17：信頼度が高い
18：信頼度が非常に高い
19：ACSの最大チャレンジを超える
20：非決済取引はサポートされていません
21：3RIトランザクションはサポートされていません
22：ACSの技術的な問題
26：認証は試行されましたが、カード会員によって実行されませんでした
80-99：DS（ディレクトリサーバー）の利用枠

ChallengeUrl

challengeUrl

半角英数256桁固定

3DS2.0認証チャレンジURL

認証結果が「C：チャレンジ」の場合に返却します。

レスポンスパラメータ：正常系

{
	"tds2TransResult": "C",
	"challengeUrl": "https://manage.tds2gw.gmopg.jp/api/v2/auth/brw?t=40a251d4459925fd6bc35db58ab6ebe3"
}

レスポンスパラメータ：正常系

Tds2TransResult=C&ChallengeUrl=https://manage.tds2gw.gmopg.jp/api/v2/auth/brw?
t=40a251d4459925fd6bc35db58ab6ebe3

Tds2ResultDcc 3DS2.0認証結果取得

3DS2.0認証の最終的な認証結果を取得します。
3DS2.0認証チャレンジURL（ChallengeUrl）のコールバックを受けたタイミングで本処理を実行してください。

リクエスト

AccessID		accessID		必須半角英数32桁固定取引ID
AccessPass		accessPass		必須半角英数32桁固定取引パスワード

URL

/payment/Tds2ResultDcc.json

リクエストパラメータ

{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de"
}

URL

/payment/Tds2ResultDcc.idPass

リクエストパラメータ

AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de

レスポンス

【決済実行】で設定されたRetUrlに、本サービスより以下パラメータを送信します。
認証結果に応じて認証フローを制御する必要があります。

・「Y：認証／口座確認に成功」または「A：処理の試行が実施された」の場合、当サービスの【3DS2.0認証後決済実行】を行ってください。
・「N：未認証／口座未確認。取引拒否」または「U：認証／口座確認を実行できなかった」、「R：認証 / 口座確認が拒否された」の場合、取引を中断してください。

正常

Tds2TransResult	tds2TransResult	半角英数1桁固定認証結果 Y：認証／口座確認に成功 A：処理の試行が実施された N：未認証／口座未確認。取引拒否 U：認証／口座確認を実行できなかった R：認証 / 口座確認が拒否された
Tds2TransResultReason	tds2TransResultReason	半角英数2桁固定認証結果理由 01：カード認証に失敗した 02：不明なデバイス 03：サポートされていないデバイス 04：認証頻度の上限を超えた 05：有効期限切れのカード 06：無効なカード番号 07：無効な取引 08：カードのレコードが存在しない 09：セキュリティ障害 10：盗難カード 11：不正の疑い 12：カード会員に取引が許可されていない 13：カード会員がサービスに登録されていない 14：取引がACSでタイムアウトした 15：信頼度が低い 16：信頼度が中程度 17：信頼度が高い 18：信頼度が非常に高い 19：ACSの最大チャレンジを超える 20：非決済取引はサポートされていません 21：3RIトランザクションはサポートされていません 22：ACSの技術的な問題 26：認証は試行されましたが、カード会員によって実行されませんでした 80-99：DS（ディレクトリサーバー）の利用枠

Tds2TransResult

tds2TransResult

半角英数1桁固定

認証結果

Y：認証／口座確認に成功
A：処理の試行が実施された
N：未認証／口座未確認。取引拒否
U：認証／口座確認を実行できなかった
R：認証 / 口座確認が拒否された

Tds2TransResultReason

tds2TransResultReason

半角英数2桁固定

認証結果理由

01：カード認証に失敗した
02：不明なデバイス
03：サポートされていないデバイス
04：認証頻度の上限を超えた
05：有効期限切れのカード
06：無効なカード番号
07：無効な取引
08：カードのレコードが存在しない
09：セキュリティ障害
10：盗難カード
11：不正の疑い
12：カード会員に取引が許可されていない
13：カード会員がサービスに登録されていない
14：取引がACSでタイムアウトした
15：信頼度が低い
16：信頼度が中程度
17：信頼度が高い
18：信頼度が非常に高い
19：ACSの最大チャレンジを超える
20：非決済取引はサポートされていません
21：3RIトランザクションはサポートされていません
22：ACSの技術的な問題
26：認証は試行されましたが、カード会員によって実行されませんでした
80-99：DS（ディレクトリサーバー）の利用枠

レスポンスパラメータ：正常系

{
    "tds2TransResult":"Y",
    "tds2TransResultReason":"18"
}

レスポンスパラメータ：正常系

Tds2TransResult=Y&Tds2TransResultReason=18

SecureTran2Dcc 3DS2.0認証後決済実行

3DS2.0サービスの結果を解析し、その情報を使用してカード会社と通信を行い決済を実施して結果を返します。

リクエスト

AccessID		accessID		必須半角英数32桁固定取引ID
AccessPass		accessPass		必須半角英数32桁固定取引パスワード

URL

/payment/SecureTran2Dcc.json

リクエストパラメータ

{
    "accessID":"8867bfeec7b7fc35f78320d01c9a6c10",
    "accessPass":"c07822acefba90d95417ae37beb198de"
}

URL

/payment/SecureTran2Dcc.idPass

リクエストパラメータ

AccessID=8867bfeec7b7fc35f78320d01c9a6c10&AccessPass=c07822acefba90d95417ae37beb198de

レスポンス

正常

OrderID	orderID	半角英数27桁オーダーID
Method	method	半角数字1桁支払方法
DccTranID	dccTranID	半角英数28桁トランザクションID
TranDate	tranDate	半角数字14桁固定決済日付
CheckString	checkString	半角英数32桁固定 MD5ハッシュ出力パラメータのオーダーID、支払方法、トランザクションID、ショップパスワードのハッシュ値を返却します。
DccCurrency	dccCurrency	半角英字3桁支払通貨コード
DccAmount	dccAmount	半角数字記号12桁支払通貨決済額支払通貨換算後の金額を返却します。 (整数部10桁、小数部2桁)
DccRate	dccRate	半角数字記号11桁為替レート支払通貨換算に適用した為替レートを返却します。(整数部6桁、小数部5桁)
Ftn	ftn	半角数字12桁 FX追跡番号(FTN) 入力パラメータの値を返却します。省略した場合は、支払通貨換算に適用した為替レートに紐付くFTNを返却します。
ClientField1	clientField1	全半角100バイト加盟店自由項目1
ClientField2	clientField2	全半角100バイト加盟店自由項目2
ClientField3	clientField3	全半角100バイト加盟店自由項目3

異常

ErrCode		errCode		半角英数3桁固定エラーコード
ErrInfo		errInfo		半角英数9桁固定エラー詳細コード

レスポンスパラメータ：正常系

{
    "orderID":"TEST-20190628-115812",
    "method":"1",
    "dccTranID":"1917900745",
    "tranDate":"20190628120831",
    "checkString":"6bff1f1547394b9fc37407dfc0d49c31",
    "dccCurrency":"USD",
    "dccAmount":"0.99",
    "dccRate":"0.00985",
    "ftn":"16755674",
    "clientField1":"自由欄１",
    "clientField2":"自由欄２",
    "clientField3":"自由欄３"
}

レスポンスパラメータ：正常系

OrderID=TEST-20190628-115812&Method=1&DccTranID=1917900745&TranDate=20190628120831&CheckString=6bff1f1547394b9fc37407dfc0d49c31&DccCurrency=USD&DccAmount=0.99&DccRate=0.00985&Ftn=16755674&ClientField1=自由欄１&ClientField2=自由欄２&ClientField3=自由欄３

レスポンスパラメータ：異常系

[
    {
        "errCode":"E01",
        "errInfo":"E01040001"
    }
]

レスポンスパラメータ：異常系

ErrCode=E01&ErrInfo=E01040001

ChangeTranDcc 金額変更

決済が完了した取引に対して決済金額の変更を行います。指定された取引情報を使用してカード会社と通信を行い、金額変更を実施します。

リクエスト

ShopID	shopID	必須半角英数13桁ショップID
ShopPass	shopPass	必須半角英数64桁ショップパスワード
AccessID	accessID	必須半角英数32桁固定取引ID
AccessPass	accessPass	必須半角英数32桁固定取引パスワード
OrderID	orderID	必須半角英数記号27桁オーダーID
ChangeAmount	changeAmount	必須半角数字7桁利用金額(金額変更後) 金額変更後の利用金額(日本円)を設定します。0円を設定した場合はエラーとなります。
ChangeTax	changeTax	半角数字7桁税送料(金額変更後) 金額変更後の税送料(日本円)を設定します。利用金額(金額変更後)+税送料(金額変更後)を支払通貨で換算した値が支払金額となります。利用金額(金額変更後) +税送料(金額変更後)で1円以上9,999,999 円以下である必要があります。
TdFlag	tdFlag	半角数字1桁 3DS利用フラグ 2：行う(3DS2.0)
Tds2Type	tds2Type	3DS2.0未対応時取り扱い仕向先カード会社が3DS2.0に未対応な場合の後続処理設定 1：3DS1.0での認証を実施（デフォルト） 2：エラーとして処理終了 3：通常オーソリを実施
SecurityCode	securityCode	半角数字3桁セキュリティコードカードの裏面(あるいは表面)に記載されている3桁の数字を設定します。
ClientField1	clientField1	全半角100バイト加盟店自由項目1
ClientField2	clientField2	全半角100バイト加盟店自由項目2
ClientField3	clientField3	全半角100バイト加盟店自由項目3
ClientFieldFlag	clientFieldFlag	半角数字1桁加盟店自由項目返却フラグ以下のいずれかを設定します。 0：返却しないデフォルト 1：返却する

3DS2.0利用パラメータ
下記パラメータは3DS2.0利用時に設定してください。

RetUrl	retUrl	必須半角英数記号256桁加盟店戻りURL 3Dセキュア認証後にお戻しする加盟店様側のURLになります。通常は必ず指定してください。モバイルアプリSDKを利用する場合は設定不要です。 URLに遷移するHTTPメソッド(GET/POST)は、CallbackTypeパラメータで切り替えることができます。
CallbackType	callbackType	コールバック方法加盟店様が指定した戻りURLに当社から戻す方式を指定します。通常は「1」(POST方式)または「3」(GET方式)を設定してください。モバイルアプリSDKを利用する場合は設定不要です。 1：通常（POST方式）（デフォルト） 2：直接受ける 3：通常（GET方式）「1」または「3」の場合、認証後のコールバック一回のみで済みます。(決済フローの「通常コールバック方式」参照) 「2」を指定すると認証初期化後、チャレンジ後の最大二回のコールバックが発生し、加えて以下のAPIを呼び出す必要があります。こちらの方式では加盟店様側で認証結果を取得できるので認証エラーの場合はオーソリを行わないようにする等、決済フローの制御が可能になります。(決済フローの「都度加盟店コールバック方式」参照) 3DS2.0認証実行 3DS2.0認証結果取得
Tds2ChAccChange	tds2ChAccChange	半角数字8桁固定会員最終更新日加盟店サイト上のこの会員の情報が更新された日付を設定します。決済用カード情報の追加や配送先住所の変更がされた日付を想定しています。新規登録された会員の場合は登録日を設定してください。更新された日付が不明な場合は未設定で構いません YYYYMMDD形式です。
Tds2ChAccDate	tds2ChAccDate	半角数字8桁固定会員作成日加盟店サイト上にてこの会員が新規登録された日付を設定します。クレジットカード番号を登録した日ではありません。ゲストとして取引を行う場合は未設定で構いません。 YYYYMMDD形式です。
Tds2ChAccPwChange	tds2ChAccPwChange	半角数字8桁固定会員パスワード変更日加盟店サイト上のこの会員のログインパスワードが変更された日付を設定します。パスワード忘れなどでリセットした場合も含まれます。ゲストとして取引を行っている場合、またはパスワードを変更したことが無い場合は未設定で構いません。 YYYYMMDD形式です。
Tds2NbPurchaseAccount	tds2NbPurchaseAccount	半角数字4桁過去6ヶ月間の購入回数加盟店サイト上にて過去6ヵ月間にこの会員がクレジットカード決済で決済成功して購入完了に至った回数を設定します。対象期間の開始日について、処理日が8/20であれば3/1以降としても良いですし、処理日時点の180日前以降としても問題ありません。
Tds2PaymentAccAge	tds2PaymentAccAge	半角数字8桁固定カード登録日加盟店サイト上のこの会員が今回の決済で利用するカード情報を登録した日付を設定します。都度カード番号を入力する場合は未設定で構いません。
Tds2ProvisionAttemptsDay	tds2ProvisionAttemptsDay	半角数字3桁過去24時間のカード追加試行回数加盟店サイト上のこの会員が、過去24時間以内にカード情報を登録した試行回数を設定します。複数種類のカードで試して失敗した回数も含めていただきます。しかし成功した回数しか分からない場合は成功回数だけで構いません。
Tds2ShipAddressUsage	tds2ShipAddressUsage	半角数字8桁固定配送先住所の初回使用日この取引での指定された配送先住所が、初めて利用された日付を設定します。過去の実績はクレジットカード決済で行われたかは問いません。加盟店サイトにて記録されている最も古い取引時の日付で構いません。会員登録なしでの取引、配送が発生しない場合は未設定で構いません。 YYYYMMDD形式です。
Tds2ShipNameInd	tds2ShipNameInd	カード会員名と配送先名の一致/不一致この取引でのクレジットカード番号の会員名と配送先情報の宛名が一致しているかを指定します。 01：カード会員名と配送先名が一致 02：カード会員名と配送先名が不一致配送が発生しない場合や配送先の宛名が不明の場合は未設定で構いません。
Tds2SuspiciousAccActivity	tds2SuspiciousAccActivity	不審行為情報今回の取引に限らずこの会員が加盟店サイト上にて不審な行動をしているかどうかを指定します。 01：不審な行動は見られなかった 02：不審な行動が見られた不明、または判断が困難な場合は未設定で構いません。過去に不正利用をしている、一般的には発生しない操作が記録されているなどの場合に設定してください。
Tds2TxnActivityDay	tds2TxnActivityDay	半角数字3桁過去24時間のカード会員の取引回数加盟店サイト上のこの会員が、過去24時間以内に取引を行った回数を設定します。クレジットカード決済で行われたか、決済に成功したかは問いません。回数が分からない場合は未設定で構いません。しかし、記録されている限りの回数を設定するようお願いします。
Tds2TxnActivityYear	tds2TxnActivityYear	半角数字3桁過去1年の取引回数加盟店サイト上のこの会員が、過去1年以内に取引を行った回数を設定します。クレジットカード決済で行われたか、決済に成功したかは問いません。対象とする期間は厳密に過去1年とする必要はありません。処理日が2022年10月10日の場合、2021年9月～2022年9月や2021年10月10日～2022年10月9日、または直近365日としても問題ありません。また1年分の履歴を保持していない場合、可能な範囲での算出で構いません。回数が分からない場合は未設定で構いません。しかし、記録されている限りの回数を設定するようお願いします。
Tds2ThreeDSReqAuthTimestamp	tds2ThreeDSReqAuthTimestamp	半角数字12桁固定ログイン日時この会員が加盟店サイトにログインした日時を設定します。ゲストとしてログインしている場合は未設定で構いません。 YYYYMMDDHHMM形式です。
Tds2ThreeDSReqAuthMethod	tds2ThreeDSReqAuthMethod	ログイン方法この会員が加盟店サイトへのログイン時に認証した方法を指定します。 01：認証なし、ゲストログイン 02：加盟店サイト自身の認証情報 03：フェデレーションIDを利用した認証 04：イシュアの認証情報　　カード会社が提供しているポイントサイトなどのログイン認証などで認証済みとしている場合 05：サードパーティ認証　　Facebook、Googleなど他サービスの認証を利用
Tds2ThreeDSReqAuthData	tds2ThreeDSReqAuthData	全半角2048桁ログイン証跡データ「ログイン方法(Tds2ThreeDSReqAuthMethod)」に、"03" を指定した場合にフェデレーションIDのプロバイダーに関する情報と関連情報を設定します。それ以外を指定している場合は未設定で構いません。
Tds2AddrMatch	tds2AddrMatch	請求先住所と配送先住所の一致/不一致この取引での請求先住所と配送先情報が一致しているかを指定します。 Y：一致 N：不一致配送が発生しない場合や判断ができない場合は未設定で構いません。コンビニ受け取りのような場合は不一致としてください。
Tds2BillAddrCity	tds2BillAddrCity	全半角50桁請求先住所の市区町村この取引での請求先住所の「市区町村」を設定します。例として「渋谷区」「横浜市」となります。日本語漢字でなくても構いません。請求先住所情報を保持していない場合は未設定で構いません。
Tds2BillAddrCountry	tds2BillAddrCountry	半角数字3桁固定請求先住所の国番号この取引での請求先住所の「国番号」を設定します。設定する番号はISO3166-1の数字3桁となります。 ITU-E.164ではないのでご注意ください。例として日本の場合は「392」です。請求先住所情報を保持していない場合は未設定で構いません。
Tds2BillAddrLine1	tds2BillAddrLine1	全半角50桁請求先住所の町域・丁目番地この取引での請求先住所の「町域・丁目番地」を設定します。請求先住所情報を保持していない場合や詳細住所が不明の場合は未設定で構いません。保持している住所を町名と建物名に分割するのが難しい場合は、桁数が収まるようにTds2BillAddrLine1～Tds2BillAddrLine3に住所を設定してください。Tds2BillAddrLine1にすべて収まる場合は、Tds2BillAddrLine2とTds2BillAddrLine3は未設定で構いません。また、都道府県や市区が含まれていても構いません。
Tds2BillAddrLine2	tds2BillAddrLine2	全半角50桁請求先住所の建物・号室この取引での請求先住所の「建物・号室」を設定します。請求先住所情報を保持していない場合や詳細住所が不明の場合は未設定で構いません。
Tds2BillAddrLine3	tds2BillAddrLine3	全半角50桁請求先住所情報の予備項目請求先住所情報に関する予備項目です。設定は不要です。
Tds2BillAddrPostCode	tds2BillAddrPostCode	半角英数16桁請求先住所の郵便番号この取引での請求先住所の「郵便番号」を設定します。ハイフンは含めても、含まなくてもどちらでも構いません。請求先住所情報を保持していない場合は未設定で構いません。
Tds2BillAddrState	tds2BillAddrState	半角英数3桁請求先住所の都道府県番号この取引での請求先住所の「都道府県番号」を設定します。こちらの都道府県コード表を参照してください。 https://www.meti.go.jp/policy/chemical_management/kasinhou/files/ippantou/table_prefecturecode.pdf 「01」～「47」からなる先頭ゼロ埋めの2桁の形式です。請求先住所情報を保持していない場合は未設定で構いません。
Tds2Email	tds2Email	半角英数記号254桁メールアドレスこの会員の電子メールアドレスを設定します。「RFC 5322」の仕様に沿った形式のみ許可されます。 2連続ドットなどのRFC違反の形式となっているメールアドレスの場合はエラーとなるため設定しないでください。メールアドレスを保持していない場合は未設定で構いません。
Tds2HomePhoneCC	tds2HomePhoneCC	半角数字3桁固定自宅電話の国コードこの会員の自宅電話の「国コード」を設定します。設定する国コードはITU-E.164の1～3桁の数字となります。 ISO3166-1ではないのでご注意ください。例として日本の場合は「81」です。プラス記号(+)はつけないでください。
Tds2HomePhoneSubscriber	tds2HomePhoneSubscriber	半角数字15桁この会員の自宅電話番号を設定します。先頭一桁目のゼロは不要です。例として東京都の場合は「3-1234-5678」です。ハイフンは含めても、含まなくてもどちらでも構いません。自宅電話として携帯電話が登録されている場合は携帯電話番号を設定してください。
Tds2MobilePhoneCC	tds2MobilePhoneCC	半角数字3桁固定携帯電話の国コードこの会員の携帯電話の「国コード」を設定します。設定する国コードはITU-E.164の1～3桁の数字となります。 ISO3166-1ではないのでご注意ください。例として日本の場合は「81」です。プラス記号(+)はつけないでください。
Tds2MobilePhoneSubscriber	tds2MobilePhoneSubscriber	半角数字15桁携帯電話番号この会員の携帯電話番号を設定します。先頭一桁目のゼロは不要です。例として「90-1234-5678」です。ハイフンは含めても、含まなくてもどちらでも構いません。
Tds2WorkPhoneCC	tds2WorkPhoneCC	半角数字3桁固定職場電話の国コードこの会員の職場電話の「国コード」を設定します。設定する国コードはITU-E.164の1～3桁の数字となります。 ISO3166-1ではないのでご注意ください。例として日本の場合は「81」です。プラス記号(+)はつけないでください。職場電話情報が無い場合は未設定で構いません。
Tds2WorkPhoneSubscriber	tds2WorkPhoneSubscriber	半角数字15桁職場電話番号この会員の自宅電話番号を設定します。先頭一桁目のゼロは不要です。例として東京都の場合は「3-1234-5678」です。ハイフンは含めても、含まなくてもどちらでも構いません。職場電話情報が無い場合は未設定で構いません。
Tds2ShipAddrCity	tds2ShipAddrCity	全半角50桁配送先住所の市区町村この取引での配送先住所の「市区町村」を設定します。例として「渋谷区」「横浜市」となります。日本語漢字でなくても構いません。配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。
Tds2ShipAddrCountry	tds2ShipAddrCountry	半角数字3桁固定配送先住所の国番号この取引での配送先住所の「国番号」を設定します。設定する番号はISO3166-1の数字3桁となります。 ITU-E.164ではないのでご注意ください。例として日本の場合は「392」です。配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。
Tds2ShipAddrLine1	tds2ShipAddrLine1	全半角50桁配送先住所の町域・丁目番地この取引での配送先住所の「町域・丁目番地」を設定します。配送が発生しない場合や配送先住所情報を保持していない場合、詳細住所が不明の場合は未設定で構いません。保持している住所を町名と建物名に分割するのが難しい場合は、桁数が収まるようにTds2ShipAddrLine1～Tds2ShipAddrLine3に住所を設定してください。Tds2ShipAddrLine1にすべて収まる場合は、Tds2ShipAddrLine2とTds2ShipAddrLine3は未設定で構いません。また、都道府県や市区が含まれていても構いません。
Tds2ShipAddrLine2	tds2ShipAddrLine2	全半角50桁配送先住所の建物・号室この取引での配送先住所の「建物・号室」を設定します。配送が発生しない場合や配送先住所情報を保持していない場合、詳細住所が不明の場合は未設定で構いません。
Tds2ShipAddrLine3	tds2ShipAddrLine3	全半角50桁配送先住所情報の予備項目配送先住所情報に関する予備項目です。設定は不要です。
Tds2ShipAddrPostCode	tds2ShipAddrPostCode	半角英数16桁配送先住所の郵便番号この取引での配送先住所の「郵便番号」を設定します。ハイフンは含めても、含まなくてもどちらでも構いません。配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。
Tds2ShipAddrState	tds2ShipAddrState	半角英数3桁配送先住所の都道府県この取引での配送先住所の「都道府県番号」を設定します。こちらの都道府県コード表を参照してください。 https://www.meti.go.jp/policy/chemical_management/kasinhou/files/ippantou/table_prefecturecode.pdf 「01」～「47」からなる先頭ゼロ埋めの2桁の形式です。配送が発生しない場合や配送先住所情報を保持していない場合は未設定で構いません。
Tds2DeliveryEmailAddress	tds2DeliveryEmailAddress	半角英数記号254桁電子配送時の配送先メールアドレスこの取引内容がWebチケットなどの電子デリバリーの場合に、配信先の電子メールアドレスを設定します。「RFC 5322」の仕様に沿った形式のみ許可されます。 2連続ドットなどのRFC違反の形式となっているメールアドレスの場合はエラーとなるため設定しないでください。電子デリバリーではない場合は未設定で構いません。
Tds2DeliveryTimeframe	tds2DeliveryTimeframe	商品出荷の時間枠商品納品時間枠を指定します。 01：電子デリバリー、商品の出荷が発生しない 02：当日出荷 03：翌日出荷 04：2日目以降の出荷
Tds2GiftCardAmount	tds2GiftCardAmount	半角数字15桁プリペイドカード/ギフトカード購入の総金額この取引がプリペイドカードまたはギフトカード購入の場合、購入した総金額を設定します。
Tds2GiftCardCount	tds2GiftCardCount	半角数字2桁プリペイドカード/ギフトカード購入の総件数この取引がプリペイドカードまたはギフトカード購入の場合、購入した総枚数を設定します。
Tds2GiftCardCurr	tds2GiftCardCurr	半角数字3桁固定プリペイドカード/ギフトカード購入の通貨コードこの取引がプリペイドカードまたはギフトカード購入の場合、購入の通貨コードを設定します。設定する番号はISO 4217の数字3桁となります。 ITU-E.164ではないのでご注意ください。例として日本円の場合は「392」です。
Tds2PreOrderDate	tds2PreOrderDate	半角数字8桁固定予約販売の発売予定日この取引が先行予約販売による決済の場合に、商品の発売予定日を設定します。 YYYYMMDD 形式です。発売予定日が不明の場合は未設定で構いません。
Tds2PreOrderPurchaseInd	tds2PreOrderPurchaseInd	予約販売の商品有無この取引が先行予約販売による決済の場合に、商品が現時点で存在するかどうかを指定します。 01：商品がある 02：予約の商品、まだ存在しない
Tds2ReorderItemsInd	tds2ReorderItemsInd	再購入情報この会員が取引対象の商品の以前も購入したことがあるかを指定します。 01：新規購入 02：再購入判別が困難な場合は未設定で構いません。新規と再購入が混在している場合は、新規購入として設定してください。
Tds2ShipInd	tds2ShipInd	商品配送方法この取引での商品の配送方法を設定します。 01：カード会員の請求先住所に配送する 02：加盟店様が保持している別の確認済み住所に配送する 03：カード会員の請求先住所と異なる住所に配送する 04：店舗へ配送/近所の店舗での受け取りであり店舗の住所は配送先住所で指定する 05：デジタル商品、オンラインサービス、電子ギフトカードおよび償還コードを含む 06：配送なし、旅行およびイベントのチケットなど 07：その他、ゲーム、配送されないデジタルサービス、電子メディアの購読料など

URL

/payment/ChangeTranDcc.json

リクエストパラメータ

{
    "shopID": "tshop11223344",
    "shopPass": "PASSWORD",
    "accessID": "4cfffa3f3ef6e90692dbc204e09b351b",
    "accessPass": "c07822acefba90d95417ae37beb198de",
    "orderID": "TEST-20190628-133057",
    "changeAmount": "200"
}

URL

/payment/ChangeTranDcc.idPass

リクエストパラメータ

ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=4cfffa3f3ef6e90692dbc204e09b351b&AccessPass=c07822acefba90d95417ae37beb198de&OrderID=TEST-20190628-133057&ChangeAmount=200

レスポンス

正常

ACS	aCS	半角数字1桁 ACS呼出判定 2：ACS呼出要(3DS2.0)
RedirectUrl	redirectUrl	3DSサーバーへのリダイレクトURL 3DS2.0認証初期化へのURL(※１) リダイレクト先ドメインテスト環境：pt01.mul-pay.jp 本番環境：manage.tds2gw.gmopg.jp

ACS

aCS

半角数字1桁

ACS呼出判定

2：ACS呼出要(3DS2.0)

RedirectUrl

redirectUrl

3DSサーバーへのリダイレクトURL

3DS2.0認証初期化へのURL(※１)

リダイレクト先ドメイン
テスト環境：pt01.mul-pay.jp
本番環境：manage.tds2gw.gmopg.jp

異常

ErrCode		errCode		半角英数3桁固定エラーコード
ErrInfo		errInfo		半角英数9桁固定エラー詳細コード

レスポンスパラメータ：正常系

{
    "aCS": "2",
    "redirectUrl": "https://manage.tds2gw.gmopg.jp/api/v2/brw/callback?transId=6e48e31f-2940-48e1-a702-ebba2f3373ee&t=dccc8a7ed85372c9accff576bff59b3a"
}

レスポンスパラメータ：正常系

ACS=2&RedirectUrl=https://manage.tds2gw.gmopg.jp/api/v2/brw/callback?transId=6e48e31f-2940-48e1-a702-ebba2f3373ee&t=dccc8a7ed85372c9accff576bff59b3a

レスポンスパラメータ：異常系

[
    {
        "errCode":"E01",
        "errInfo":"E01040001"
    }
]

レスポンスパラメータ：異常系

ErrCode=E01&ErrInfo=E01040001

CancelTranDcc 決済取消

決済が完了した取引に対して決済内容の取り消しを行います。
指定された取引情報および為替レートを使用して、取り消しを実施します。

リクエスト

ShopID	shopID	必須半角英数13桁ショップID
ShopPass	shopPass	必須半角英数64桁ショップパスワード
AccessID	accessID	必須半角英数32桁固定取引ID
AccessPass	accessPass	必須半角英数32桁固定取引パスワード
OrderID	orderID	必須半角英数記号27桁オーダーID
DccFlag	dccFlag	半角数字1桁 DCCフラグ 0：売上時の為替レート(デフォルト) 1：取消時の為替レート

URL

/payment/CancelTranDcc.json

リクエストパラメータ

{
    "shopID": "tshop11223344",
    "shopPass": "PASSWORD",
    "accessID": "4cfffa3f3ef6e90692dbc204e09b351b",
    "accessPass": "c07822acefba90d95417ae37beb198de",
    "orderID": "TEST-20190628-131929",
    "dccFlag": "0"
}

URL

/payment/CancelTranDcc.idPass

リクエストパラメータ

ShopID=tshop11223344&ShopPass=PASSWORD&AccessID=4cfffa3f3ef6e90692dbc204e09b351b&AccessPass=c07822acefba90d95417ae37beb198de&OrderID=TEST-20190628-131929&DccFlag=0

レスポンス

正常

AccessID	accessID	半角英数32桁固定取引ID
OrderID	orderID	半角英数記号27桁オーダーID
Status	status	現状態取消成功時は以下を返却します。・VOID 取消失敗時は処理前のステータスを返却します。
DccAmount	dccAmount	半角数字記号12桁支払通貨決済額(取消後) 支払通貨換算した取消後の金額を返却します。(整数部10桁、小数部2桁)
DccRate	dccRate	半角数字記号11桁為替レート【取消】呼出時に設定した為替レートの値を返却します。(整数部6桁、小数部5桁)
Ftn	ftn	半角数字12桁 FX追跡番号(FTN) 支払通貨換算に適用した為替レートに紐付くFTNを返却します。

異常

ErrCode		errCode		半角英数3桁固定エラーコード
ErrInfo		errInfo		半角英数9桁固定エラー詳細コード

レスポンスパラメータ：正常系

{
    "accessID": "b4e08d3cd75df2755d32b783e40bf13b",
    "orderID": "TEST-20190628-115812",
    "status": "VOID",
    "dccAmount": "0",
    "dccRate": "0.00985",
    "ftn": "16755674"
}

レスポンスパラメータ：正常系

AccessID=b4e08d3cd75df2755d32b783e40bf13b&OrderID=TEST-20190628-115812&Status=VOID&DccAmount=0&DccRate=0.00985&Ftn=16755674

レスポンスパラメータ：異常系

[
    {
        "errCode":"E01",
        "errInfo":"E01040001"
    }
]

レスポンスパラメータ：異常系

ErrCode=E01&ErrInfo=E01040001

SearchRateAllDcc 全レート照会

支払対象となる全通貨における為替レート(最新分)を一括で取得します。

リクエスト

ShopID		shopID		必須半角英数13桁ショップID
ShopPass		shopPass		必須半角英数64桁ショップパスワード

URL

/payment/SearchRateAllDcc.json

リクエストパラメータ

{
  "shopID": "tshop99887902",
  "shopPass": "7ry53fqm"
}

URL

/payment/SearchRateAllDcc.idPass

リクエストパラメータ

ShopID=tshop99887902&ShopPass=7ry53fqm

レスポンス

正常

RateData		rateData		レート情報各通貨のレート照会情報のXMLをBASE64エンコーディングした値 (次頁のXMLフォーマットおよびサンプルを参照 ※１)

異常

ErrCode		errCode		半角英数3桁固定エラーコード
ErrInfo		errInfo		半角英数9桁固定エラー詳細コード

レスポンスパラメータ：正常系

{
  "rateData": ""
}

レスポンスパラメータ：正常系

RateData=

レスポンスパラメータ：異常系

[
    {
        "errCode":"E01",
        "errInfo":"E01040001"
    }
]

レスポンスパラメータ：異常系

ErrCode=E01&ErrInfo=E01040001

※１：以下のXMLフォーマットをBASE64エンコーディングした値を返却します。

[XMLフォーマット]

ratesInfo	レート情報レート情報親属性
rate	レート取扱い通貨全てを、通貨ごとの複数属性で返却します。
dccCurrency	半角英字3桁支払通貨コード支払通貨コード(英字)を返却します。
dccRate	半角数字記号11桁為替レート最新の為替レート(整数部6桁、小数部5桁)を返却します。
ftn	半角数字12桁 FX追跡番号(FTN) 最大12桁の数字を返却します。
updated	半角数字13桁更新日時当サービスが為替レートの取込みを実施した日時をエポック (1970/1/1 00:00:00+0000 )からのミリ秒数で返却します。

[XML 例（エンコード前）]


<ratesInfo>
    <rate>
        <dccCurrency>USD</dccCurrency>
        <dccRate>0.00834</dccRate>
        <ftn>123456789012</ftn>
        <updated>1457576007345</updated>
    </rate>
    <rate>
        <dccCurrency>EUR</dccCurrency>
        <dccRate>0.00747</dccRate>
        <ftn>123456789013</ftn>
        <updated>1457576007345</updated>
    </rate>
    <rate>
        <dccCurrency>BRL</dccCurrency>
        <dccRate>0.02897</dccRate>
        <ftn>123456789014</ftn>
        <updated>1457576007345</updated>
    </rate>
    ･
    ･
</ratesInfo>

SearchRateDcc ショップ別レート照会

購入対象商品の金額について、加盟店通貨から支払通貨に換算した金額(為替レート換算および為替手数料を含む金額)を取得します。

リクエスト

ShopID	shopID	必須半角英数13桁ショップID
ShopPass	shopPass	必須半角英数64桁ショップパスワード
Amount	amount	必須利用金額税送料を含む金額(加盟店通貨)を指定してください。整数部桁数、小数点以下桁数は、加盟店通貨により異なります。
DccCurrency	dccCurrency	半角英字3桁支払通貨コード設定できるコードについてはこちら
Ftn	ftn	半角数字12桁 FX追跡番号(FTN) 最大1桁の数字を設定します。

※DccCurrencyかFTNのいずれか一方のみを設定してください。
DccCurrencyを設定した場合は、送信時点の日付における為替レートが要求されます。

URL

/payment/SearchRateDcc.json

リクエストパラメータ

{
    "shopID": "tshop99887902",
    "shopPass": "PASSWORD",
    "amount": "100",
    "dccCurrency": "USD"
}

URL

/payment/SearchRateDcc.idPass

リクエストパラメータ

ShopID=tshop99887902&ShopPass=PASSWORD&Amount=100&DccCurrency=USD

レスポンス

正常

DccCurrency	dccCurrency	半角英字3桁支払通貨コード
DccAmount	dccAmount	支払通貨決済額【レート照会】で換算された値を返却します。整数部桁数、小数点以下桁数は、支払通貨により異なります。
DccRate	dccRate	半角数字記号11桁為替レート支払通貨が指定された場合は最新の為替レート、FX追跡番号(FTN)が指定された場合はFTNに紐付く為替レートを返却します。(整数部6桁、小数部5桁)
Ftn	ftn	半角数字12桁 FX追跡番号入力パラメータの値を返却します。入力パラメータが省略された場合は、為替レートに紐付くFTNを返却します。
Updated	updated	半角数字13桁更新日時当サービスが為替レートの取込みを実施した日時をエポック (1970/1/1 00:00:00 +0000 からのミリ秒数で返却します。

異常

ErrCode		errCode		半角英数3桁固定エラーコード
ErrInfo		errInfo		半角英数9桁固定エラー詳細コード

レスポンスパラメータ：正常系

{
    "dccCurrency": "USD",
    "dccAmount": "0.99",
    "dccRate": "0.00985",
    "ftn": "16755674",
    "updated": "1558317608194"
}

レスポンスパラメータ：正常系

DccCurrency=USD&DccAmount=0.99&DccRate=0.00985&Ftn=16755674&Updated=1558317608194

レスポンスパラメータ：異常系

[
    {
        "errCode":"E01",
        "errInfo":"E01040001"
    }
]

レスポンスパラメータ：異常系

ErrCode=E01&ErrInfo=E01040001

SearchTradeMulti 取引状態参照

対象取引の取引状態を取得します。
※idPass版にのみ対応しています。json版には対応しておりません。

リクエスト

ShopID		必須半角英数13桁ショップID
ShopPass		必須半角英数64桁ショップパスワード
OrderID		必須半角英数記号27桁オーダーID
PayType		必須半角数字2桁決済方法 41：多通貨クレジットカード決済（DCC）

URL

/payment/SearchTradeMulti.idPass

リクエストパラメータ

ShopID=tshop11223344&ShopPass=PASSWORD&OrderID=ORDER0000001&PayType=41

レスポンス

正常

Status		現状態 UNPROCESSED：未決済 CAPTURE：即時売上 AUTHENTICATED：未決済(3DS登録済み) CHANGEAUTH：変更未決済(3DS登録済み) VOID：取消
ProcessDate		半角数字14桁固定処理日時 yyyyMMddHHmmss書式
JobCd		処理区分 CAPTURE：即時売上 CHANGE：金額変更 VOID：取消
AccessID		半角英数32桁固定取引ID
AccessPass		半角英数32桁固定取引パスワード
ItemCode		半角英数7桁商品コード
Amount		半角数字7桁利用金額
Tax		半角数字7桁税送料
Currency		半角英数3桁通貨コード
SiteID		半角英数13桁サイトID
MemberID		半角英数60桁会員ID
CardNo		半角数字16桁カード番号下4桁以外は伏字となります。
Expire		半角数字4桁有効期限
Method		半角数字1桁支払方法 1：一括
ClientField1		全半角100バイト加盟店自由項目1
ClientField2		全半角100バイト加盟店自由項目2
ClientField3		全半角100バイト加盟店自由項目3
PayType		半角数字2桁決済方法 41：多通貨クレジットカード決済（DCC）
TotalCancelAmount		半角数字7桁減額金額の累積
TotalCancelTax		半角数字7桁減額税送料の累積
TotalIncreaseAmount		半角数字7桁増額金額の累積
TotalIncreaseTax		半角数字7桁増額税送料の累積
DccAmount		半角数字12桁支払通貨決済額為替レート変換後の金額(為替手数料、税送料込み)を返却します。
DccFtn		半角数字12桁 FX追跡番号(FTN)

異常

ErrCode		半角英数3桁固定エラーコード
ErrInfo		半角英数9桁固定エラー詳細コード

レスポンスパラメータ：正常系

Status=CAPTURE&ProcessDate=20190213200436&JobCd=CAPTURE&AccessID=67ed6da3551771c9f592cd6f7a19a90c&AccessPass=0695cc5eb676f9e11ab6e432f3747941&ItemCode=&Amount=10000&Tax=10000&Currency=&SiteID=&MemberID=&CardNo=&Expire=&Method=&ClientField1=&ClientField2=&ClientField3=&PayType=41&TotalCancelAmount=500&TotalCancelTax=50&TotalIncreaseAmount=&TotalIncreaseTax=&DccAmount=&DccFtn=

レスポンスパラメータ：異常系

ErrCode=E01&ErrInfo=E01040001

多通貨クレジットカード決済（DCC）

多通貨クレジットカード決済（DCC） 3DS2.0 API一覧

HTTP仕様（.idPass）

HTTP仕様（.json）

Content-Type: application/x-www-form-urlencoded;charset=windows-31j

POST

Content-Type: text/plain;charset=windows-31j

200：常に200を返却

Content-Type: application/json;charset=UTF-8

POST

Content-Type: application/json;charset=UTF-8

200：正常時 400：入力パラメータエラー、加盟店設定エラー 500：システムエラー 502：決済エラー ※以下のエラーコードはhttp200で返却される可能性がございます。 ・E90010001 ・E92000001 ・E92000002 ・E91099996 ・E91099997

EntryTranDcc 取引登録

リクエスト

3DS2.0未対応時取り扱い

レスポンス

正常

支払通貨決済額

為替レート

異常

ExecTranDcc 決済実行

リクエスト

トークンを使用する場合各パラメータはトークン利用のみ設定してください。

会員IDを使用する場合下記パラメータは会員ID利用のみ設定してください。

カード登録連番モード

カード番号を使用する場合下記パラメータはカード番号利用のみ設定してください。

3DS2.0利用パラメータ下記パラメータは3DS2.0利用時に設定してください。

加盟店戻りURL

コールバック方法

会員最終更新日

会員作成日

会員パスワード変更日

過去6ヶ月間の購入回数

カード登録日

過去24時間のカード追加試行回数

配送先住所の初回使用日

カード会員名と配送先名の一致/不一致

不審行為情報

過去24時間のカード会員の取引回数

過去1年の取引回数

ログイン日時

ログイン方法

ログイン証跡データ

請求先住所と配送先住所の一致/不一致

請求先住所の市区町村

請求先住所の国番号

請求先住所の町域・丁目番地

請求先住所の建物・号室

請求先住所情報の予備項目

請求先住所の郵便番号

請求先住所の都道府県番号

メールアドレス

自宅電話の国コード

携帯電話の国コード

携帯電話番号

職場電話の国コード

職場電話番号

配送先住所の市区町村

配送先住所の国番号

配送先住所の町域・丁目番地

配送先住所の建物・号室

配送先住所情報の予備項目

配送先住所の郵便番号

配送先住所の都道府県

電子配送時の配送先メールアドレス

商品出荷の時間枠

プリペイドカード/ギフトカード購入の総金額

プリペイドカード/ギフトカード購入の総件数

プリペイドカード/ギフトカード購入の通貨コード

予約販売の発売予定日

予約販売の商品有無

再購入情報

商品配送方法

レスポンス

正常

3DSサーバーへのリダイレクトURL

異常

カード会社の3DS2.0画面を呼び出す

リクエスト

3DS2.0開始 URL

トークンを使用する場合
各パラメータはトークン利用のみ設定してください。

会員IDを使用する場合
下記パラメータは会員ID利用のみ設定してください。

カード番号を使用する場合
下記パラメータはカード番号利用のみ設定してください。

3DS2.0利用パラメータ
下記パラメータは3DS2.0利用時に設定してください。